home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 26 / AACD 26.iso / AACD / System / XFD / User / Docs / xfdDecrunchAddr.doc < prev    next >
Encoding:
Text File  |  2001-09-16  |  3.2 KB  |  95 lines
  1. NAME
  2.     xfdDecrunch 1.6
  3.  
  4. SYNOPSIS
  5.     xfdDecrunchAddr SOURCE/A,DEST=TO,HEADER/N,ADDHEAD/S,DECRADDR,
  6.     JMPADDR,STCO=STORECOMMENT/S
  7.  
  8. DESCRIPTION
  9.     xfdDecrunchAddr unpacks address crunched executablefiles. It
  10.     requires Kickstart V37+.
  11.  
  12.     When calling it "xfdDecrunchAddr ?" you get above synopsis.
  13.     Entering "?" here again brings you a deeper help.
  14.  
  15.     SOURCE specifies the file(s) that should be decrunched.
  16.     Wildcards are not supported.
  17.  
  18.     DEST is the file to save the result to.
  19.     Without DEST, the old file will be overwritten.
  20.  
  21.     HEADER specifies the header type, which should be linked to
  22.     the decrunched file:
  23.     0 - No header is linked.
  24.     1 - Only the executable hunk information is linked. This is useful
  25.         when the executable program is completely relocatable and thus
  26.         needs not to be forced to a certain memory region.
  27.     2 - Only the executable hunk information is linked, but this
  28.         contains one additional BSS hunk.
  29.     3 - The xfdDecrunch 1.08 simple header is linked.
  30.     4 - The xfdDecrunch 1.08 professional header is linked.
  31.     11- This is like 1, but the header overwrites file start and end.
  32.     12- This is like 2, but the header overwrites file start and end.
  33.     13- This is like 12, but has an additional empty RELOC hunk.
  34.     
  35.     Header types 1 and 2 are useful, when the decrunched file is again
  36.     crunched with another cruncher. The other headers would hide this
  37.     and xfd cannot recognize the file. Be careful when using this
  38.     header, as created files will crash, when using absolute addresses.
  39.  
  40.     Header types 11 to 13 are useful, when a file is double time
  41.     address crunched and the inner file-structure is overwritten by
  42.     NOP's or other commands. Be sure you know what you do when using
  43.     these headers!
  44.  
  45.     xfdDecrunchAddr automatically checks if destination is normal
  46.     executable (should not happen ever - only when someone forgot to
  47.     unhunk the file before crunching) or if it is double crunched
  48.     by testing header type 1 and 2 internally. A message appears in
  49.     case xfdDecrunchAddr got such an file.
  50.     You should save the file with the header type printed there and
  51.     start xfdDecrunchAddr again. When header type 0 is told it maybe
  52.     needed to use types 11 to 13.
  53.  
  54.     A special XFD external is supplied in LIBS:xfd/, which recognizes
  55.     xfdDecrunch, Object Master and other link headers and removes them.
  56.     You can use it to change the header type of decrunched file.
  57.  
  58.     ADDHEAD forces xfdDecrunchAddr to do nothing except adding one
  59.     of above headers. For headers 3 and 4 you need to specify DECRADDR
  60.     and JMPADDR. If no JMPADDR is given, xfdDecrunchAddr uses the
  61.     DECRADDR instead for JumpIn as well.
  62.     
  63.     STORECOMMENT stores the jump address and decrunch address of file
  64.     in file comment when uncrunching with xfd.
  65.  
  66. HISTORY
  67.     xfdDecrunchAddr 1.6
  68.     - corrected email address
  69.  
  70.     xfdDecrunchAddr 1.5
  71.     - added STORECOMMENT keyword
  72.  
  73.     xfdDecrunchAddr 1.4
  74.     - Fixed serious bug. Previous versions switched decrunch address
  75.       and jump address, when the file was crunched.
  76.  
  77.     xfdDecrunchAddr 1.3
  78.     - added new headers
  79.  
  80.     xfdDecrunchAddr 1.2
  81.     - bug fix in help text
  82.  
  83.     xfdDecrunchAddr 1.1
  84.     - added ADDHEAD, DECRADDR and JMPADDR keywords and header addition
  85.  
  86.     xfdDecrunchAddr 1.0
  87.     - first version
  88.  
  89. COPYRIGHT
  90.     xfdDecrunchAddr is freely distributable and for
  91.     noncommercial use only.
  92.  
  93. AUTHOR
  94.     Dirk Stöcker <stoecker@epost.de>
  95.